home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / UTILREEN / PPP108.LZH / PPP108.DOC < prev    next >
Text File  |  1988-06-03  |  22KB  |  790 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                     Programmable Printer PopUp Users Guide
  23.  
  24.  
  25.          (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved
  26.  
  27.  
  28.                                  Revision 1.08
  29.  
  30.  
  31.                                     6/03/88
  32.  
  33.  
  34.  
  35.  
  36.  
  37. Programmable Printer PopUp Users Guide                            Version 1.08
  38.  
  39.  
  40.  
  41.  
  42.                  Welcome to PPP - Programmable Printer Pop-Up
  43.  
  44.  
  45.      This program is being distributed as user-supported software.
  46.  
  47.      A limited license is granted to all users of this program, to make
  48.      copies of this program and distribute them to other users, with the
  49.      following conditions :
  50.  
  51.      1. The program is not to be distributed to others in modified form.
  52.      2. No fee is to be charged (or any other consideration received) for
  53.         copying or distributing the program without an express written
  54.         agreement with :
  55.                                 Mark Allen Neil
  56.                                 5627 Silver Leaf Road
  57.                                 San Jose, CA  95138
  58.  
  59.      You are encouraged to copy and share this program with other users.
  60.  
  61.  
  62.      If you find this program useful, please consider sending a contribution
  63.      of $20.00 to the above address to support future enhancements.  Thanks.
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96. (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved                2
  97.  
  98.  
  99.  
  100. Programmable Printer PopUp Users Guide                            Version 1.08
  101.  
  102.  
  103.  
  104.  
  105.  
  106.                                 Table Of Contents
  107.  
  108.  
  109.  
  110.           1.0  Introduction
  111.  
  112.           2.0  Features
  113.  
  114.             2.1  Important files
  115.             2.2  The PPP Main Menu
  116.             2.3  The Help Menu
  117.             2.3.1  The HotKey Menu
  118.             2.3.2  The Printer Selection Menu
  119.  
  120.           3.0  Command Line Switches
  121.  
  122.           4.0  Printer Definition Files
  123.  
  124.           5.0  Acknowledgments
  125.  
  126.           6.0  Revision History
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159. (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved                3
  160.  
  161.  
  162.  
  163. Programmable Printer PopUp Users Guide                            Version 1.08
  164.  
  165.  
  166.  
  167.  1.0  Introduction
  168.  
  169.      Programmable printer popup (PPP) is a utility which allows you to send
  170.      configuration codes to your printer.  PPP can be loaded as a resident
  171.      utility (60K), or it can be executed from a run time prompt with command
  172.      line parameters.  This document will explain in detail what PPP does, and
  173.      how to use it to your advantage.  First, however, I would like to give you
  174.      some background on why I wrote this program.
  175.  
  176.      I recently purchased a dot-matrix printer, the Toshiba P321 to be exact.
  177.      I bought this printer because it has beautiful letter quality print and a
  178.      very fast, very legible draft mode.  Unfortunately, many software
  179.      packages fail to support this printer, and I did not purchase an
  180.      emulation option.  I immediately began searching through the bulletin
  181.      boards to which I belong for a resident printer control program for the
  182.      P321.  I found a few programs which would configure the printer, but none
  183.      which were resident, and to be honest, none which had a sensible screen
  184.      layout (well, in my opinion).
  185.  
  186.      It occurred to me that others might also have printers which weren't
  187.      commonly supported, and might like a utility to allow them to configure
  188.      their printers.
  189.  
  190.      I started off by writing a simple program in TURBO PASCAL to send
  191.      configuration codes to the printer.  Then I made the whole mess resident
  192.      using some PASCAL source routines downloaded from a local BBS (see
  193.      acknowledgements).  Finally I sped the screen I/O up with some different
  194.      source routines, also downloaded (again, see acknowledgements).
  195.  
  196.      One last note : I will be using trade names in this document (e.g. EPSON)
  197.      without designating the owner, but I will clearly designate trade names
  198.      in capital letter.  I hope my use of the trade names doesn't step on
  199.      anyone's toes.
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222. (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved                4
  223.  
  224.  
  225.  
  226. Programmable Printer PopUp Users Guide                            Version 1.08
  227.  
  228.  
  229.  
  230.  2.0  Features
  231.  
  232.      PPP was designed to be as easy to use as possible.  There are now two or
  233.      three printer popup programs on the market which have more features, but
  234.      there are advantages to a program with fewer features :
  235.  
  236.       - Easier to learn
  237.       - Easier to use
  238.       - 80 % of the "nifty" features are useless day to day
  239.       - PPP costs less
  240.  
  241.  2.1  Important files
  242.  
  243.      There are 2 basic file types which make up the PPP package.  The first is
  244.      the PPP executable file, called PPP108.COM.  The other type of files are
  245.      called "printer definition files".  Each one of these files has the
  246.      extension ".PPP", e.g. P321.PPP.  The printer definition files define the
  247.      control codes which PPP will send to the printer.  You may have several
  248.      printer control files, and you can switch between them at will.
  249.  
  250.  
  251.  2.2  The PPP Main Menu
  252.  
  253.      When PPP is invoked, either from a command line or by pressing the
  254.      "hotkey", the user is presented with a menu of choices.  This menu consists
  255.      of a list of "options" from which the user can select.  Any combination of
  256.      options can be selected.  An option is selected by moving the ">" character
  257.      up or down to the desired option and pressing the space bar.  Options can
  258.      be toggled off and on by pressing the space bar repeatedly.  An option is
  259.      "selected" when it appears in reverse video.
  260.  
  261.      An "option" is something you would like to tell the printer to do.  For
  262.      example, turning on bold print, enabling compressed mode, or even sending
  263.      the string "Dear Sir," to the printer.  The definition of each option is
  264.      completely under the users control, because the user can customize his
  265.      option menu (Section 4).
  266.  
  267.      When finished selecting options, the user can either hit <RETURN> to send
  268.      the codes to the printer, or <ESC> to exit PPP with no action.
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285. (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved                5
  286.  
  287.  
  288.  
  289. Programmable Printer PopUp Users Guide                            Version 1.08
  290.  
  291.  
  292.      Below is an example of a PPP main menu designed for use with the Toshiba
  293.      P321 printer :
  294.  
  295.                        +============================+
  296.      Title ------->    |     P321 Printer Control   |
  297.                        +----------------------------+
  298.      Options ----->    | > Eject Page               |
  299.      (up to 50)        |   High Speed               |
  300.                        |   Quality Elite            |
  301.                        |   Quality Courier          |
  302.                        |   10.0 cpi                 |
  303.                        |   12.0 cpi                 |
  304.                        |   16.7 cpi                 |
  305.                        |   Italics On               |
  306.                        |   Italics Off              |
  307.                        |   Bold On                  |
  308.                        |   Bold Off                 |
  309.      F1 key brings up  |   "Dear Sir,"              |
  310.      Help Menu ---->   +=[ F1 - HELP ]====[ 01/12 ]=+ <-- Current/Total options
  311.  
  312.      The <Page Up> and <Page Down> keys can be used to scroll through multiple
  313.      page options.
  314.  
  315.  2.3  The Help Menu
  316.  
  317.      If you have trouble remembering what to do, pressing the F1 key will bring
  318.      up a help menu screen.
  319.  
  320.      This is the PPP Help screen :
  321.  
  322.                  +==========================================+
  323.                  |             PPP Help Screen              |
  324.                  +------------------------------------------+
  325.                  | <UP ARROW>     Scroll to previous option |
  326.                  | <DOWN ARROW>   Scroll to next option     |
  327.                  | <PAGE UP>      Previous page of options  |
  328.                  | <PAGE DOWN>    Next page of options      |
  329.                  | <SPACE BAR>    Toggle highlighting       |
  330.                  | <ESC>          Exit without action       |
  331.                  | <RETURN>       Send highlighted commands |
  332.                  |                to printer                |
  333.                  +------------------------------------------+
  334.                  | F9             Change Hotkey             |
  335.                  | F10            Change Printer File       |
  336.                  +========[ Hit any key to exit help ]======+
  337.  
  338.      This screen gives a short description of the keys used in the PPP main
  339.      menu.  There are 2 functions which can be accessed from this menu, changing
  340.      the "hotkey" (F9 key) and changing the current printer file (F10 key).
  341.      Hitting any other key will return you to the main menu.
  342.  
  343.      Please note that the HotKey menu and the Printer File menu can be reached
  344.      directly from the main menu by using F9 or F10, bypassing the help screen
  345.      entirely.
  346.  
  347.  
  348. (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved                6
  349.  
  350.  
  351.  
  352. Programmable Printer PopUp Users Guide                            Version 1.08
  353.  
  354.  
  355.  2.3.1  The HotKey Menu
  356.  
  357.      The HotKey menu appears if the user presses F9, either from the Help menu
  358.      or the Main menu.  The "hotkey" is the key, or combination of keys which
  359.      causes PPP in a resident mode to appear on the screen.  The hotkeys which
  360.      can be recognized by PPP are the function keys F3 through F10, <ALT> F1
  361.      through <ALT> F10, and <CTRL> F1 through <CTRL> F10.  The hotkey is
  362.      unimportant when PPP is used as a non-resident utility.  The default hotkey
  363.      used by PPP is <ALT> F8.
  364.  
  365.      When the HotKey menu appears, hit the key combination that you want to
  366.      invoke PPP.  Choose a combination which doesn't conflict with the software
  367.      you use most often.  When you enter the new combination, the keyboard scan
  368.      code for the chosen hotkey will appear on the menu for three seconds, and
  369.      then control will return to the Main menu.If you enter the HotKey menu and
  370.      decide not to change the current hotkey, press the <ESC> key.
  371.  
  372.      To permanently change the hotkey, use the following table to determine the
  373.      scan code for the desired hotkey, and edit this number into the batch file
  374.      which starts PPP108 (Section 3).   PPP will only accept the key
  375.      combinations defined in the table below.
  376.  
  377.      HotKey     Scan Code     HotKey     Scan Code     HotKey     Scan Code
  378.  
  379.      F1         RESERVED      <CTRL> F1         94     <ALT> F1         104
  380.      F2               60      <CTRL> F2         95     <ALT> F2         105
  381.      F3               61      <CTRL> F3         96     <ALT> F3         106
  382.      F4               62      <CTRL> F4         97     <ALT> F4         107
  383.      F5               63      <CTRL> F5         98     <ALT> F5         108
  384.      F6               64      <CTRL> F6         99     <ALT> F6         109
  385.      F7               65      <CTRL> F7        100     <ALT> F7         110
  386.      F8               66      <CTRL> F8        101     <ALT> F8         111
  387.      F9         RESERVED      <CTRL> F9        102     <ALT> F9         112
  388.      F10        RESERVED      <CTRL> F10       103     <ALT> F10        113
  389.  
  390.  
  391.      This is the PPP HotKey screen :
  392.  
  393.                                +======================+
  394.                                |  Hit Key Combination |
  395.                                |    for New HotKey    |
  396.                                |                      |
  397.                                | Current Hotkey = 108 |
  398.                                |                      |
  399.                                | New Hotkey     =     |
  400.                                |                      |
  401.                                +==[ <ESC> to Abort ]==+
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411. (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved                7
  412.  
  413.  
  414.  
  415. Programmable Printer PopUp Users Guide                            Version 1.08
  416.  
  417.  
  418.  2.3.2  The Printer Selection Menu
  419.  
  420.      The Printer Selection menu appears if the user presses F10, either from the Help
  421.      menu or the Main menu.  This menu presents a list of all of the printer
  422.      definition files (*.PPP) in the PPP default directory (where PPP was
  423.      invoked).  A maximum of 20 files will be displayed.  The first printer
  424.      listed appears in reverse video.  Use the up and down arrow keys to
  425.      highlight a new printer, and hit <RETURN> to select the new printer.  PPP
  426.      will default upon initialization to the first printer definition file it
  427.      finds in the current directory.
  428.  
  429.      To permanently change the default printer definition file, edit the name of
  430.      the file into the batch file which starts PPP (Section 3).
  431.  
  432.      This is the PPP Printer Selection screen :
  433.  
  434.  
  435.                                  +==========+
  436.                                  | Printers |
  437.                                  +----------+
  438.              Printer definition  | P321     |
  439.              files ------ >      | EPSON    |
  440.                                  | OKIDATA  |
  441.                                  | CITIZEN  |
  442.                                  | PROPRT   |
  443.                                  | NEC-P5   |
  444.                                  | PRISM    |
  445.                                  +==========+
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474. (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved                8
  475.  
  476.  
  477.  
  478. Programmable Printer PopUp Users Guide                            Version 1.08
  479.  
  480.  
  481.  
  482.  3.0  Command Line Switches
  483.  
  484.      The default configuration of PPP can be modified by entering new defaults
  485.      on the command line, preceded by "switches".  The command line switches
  486.      recognized by PPP are defined as follows :
  487.  
  488.      -R [\R,/R] nnn   :  This is the Residency switch.  If you want PPP to be a
  489.                          resident application, include this switch.  The default
  490.                          is non-resident.  The "nnn" is the 3 digit hotkey which
  491.                          causes PPP to appear (Section 2.3.1).
  492.  
  493.      -D [\D,/D] fname :  This is the Default printer configuration file name
  494.                          switch.  This switch tells PPP which printer
  495.                          configuration file to use.  If this switch is omitted,
  496.                          PPP will find the first "PPP" file in the directory
  497.  
  498.      -Q [\Q,/Q]       :  This is the "quick" startup switch, and disables the
  499.                          startup screen.  PPP would be an impractical
  500.                          tool if you had to see my name all the time, but at
  501.                          least the first time you will see who wrote PPP.
  502.  
  503.      Examples :
  504.  
  505.      A>PPP               invoke PPP, non-resident, default to first .PPP file
  506.  
  507.      A>PPP -Q -R 108     invoke PPP, resident with <ALT> F5, no startup screen
  508.  
  509.      A>PPP \Q -D EPSON   invoke PPP, non-resident, default to EPSON.PPP
  510.                          configuration file, no startup screen
  511.  
  512.      A>PPP -Q /R -D P321 invoke PPP, default resident with <CNTL> F9, default
  513.                          to P321.PPP configuration file, no startup screen
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537. (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved                9
  538.  
  539.  
  540.  
  541. Programmable Printer PopUp Users Guide                            Version 1.08
  542.  
  543.  
  544.  4.0  Printer Definition Files
  545.  
  546.      PPP is useless without a definition of control commands to send to the
  547.      printer.  Each printer must have at least one printer definition file
  548.      defining the control commands.  Printer definition files must have the
  549.      extension ".PPP", and they must exist in the directory from which PPP is
  550.      invoked.  Printer definition files are in ASCII format, e.g. they can
  551.      contain no control characters nor tabs.  When editting or creating a new
  552.      printer definition file, edit your work using a "non-document" mode, or
  553.      use a straight ASCII editor, such as PC-Write.
  554.  
  555.      The first line of a printer definition file contains the title.  This title
  556.      appears in the PPP main menu.  The title cannot be more than 40 characters
  557.      in length.
  558.  
  559.      Examples :
  560.  
  561.      P321 Printer Control
  562.  
  563.      Mark's Special Control Menu
  564.  
  565.  
  566.      The next sequence of lines define the printer control options.  Each line
  567.      defines a separate control option.  There can be up to 50 options in each
  568.      file.  Each control option has two parts, the option name, and a sequence
  569.      of decimal byte (< 256) values to send to the printer when that option is
  570.      selected.  The option field occupies the first 40 characters of the line,
  571.      and the byte values follow on the same line anywhere after column 40.
  572.      There can be no additional spaces following the last control byte on a
  573.      line.
  574.  
  575.      Examples :
  576.  
  577.      Option name                           40   Control bytes
  578.  
  579.      Eject Page                               12
  580.  
  581.      10.0 cpi                                             27 42 48 27 69 49 50
  582.  
  583.      "DEAR SIR,"                             68 69 65 82 32 83 73 82 44 13 10
  584.  
  585.  
  586.      The last example above send the string "DEAR SIR," to the printer.
  587.  
  588.      After the last option line, the next line must contain a star "*",
  589.      signifying the end of the printer definition file.
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600. (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved               10
  601.  
  602.  
  603.  
  604. Programmable Printer PopUp Users Guide                            Version 1.08
  605.  
  606.  
  607.  
  608.      Sample printer definition file for Toshiba P321 printer :
  609.  
  610.  
  611.      P321 Printer Control
  612.      Eject Page                               12
  613.      High Speed                               27 42 48
  614.      Quality Elite                            27 42 49
  615.      Quality Courier                          27 42 50
  616.      10.0 cpi                                 27 42 48 27 69 49 50
  617.      12.0 cpi                                 27 42 48 27 69 49 48
  618.      16.7 cpi                                 27 42 48 27 69 49 48 27 91
  619.      Italics On                               27 18
  620.      Italics Off                              27 20
  621.      Bold On                                  27 75 51
  622.      Bold Off                                 27 77
  623.      "DEAR SIR,"                              68 69 65 82 32 83 73 82 44 13 10
  624.      *
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663. (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved               11
  664.  
  665.  
  666.  
  667. Programmable Printer PopUp Users Guide                            Version 1.08
  668.  
  669.  
  670.  5.0  Acknowledgments
  671.  
  672.  
  673.      This program would not have been possible were it not for the superior
  674.      programming skill of the following individuals :
  675.  
  676.      STAY-RES routines written by Lane H. Ferris of San Francisco, Ca.  These
  677.      public domain routines allowed me to make PPP a resident application.
  678.  
  679.      Q SCREEN routines written by Jim LeMay of Ft. Worth, Tx.  These routines
  680.      sped up my screen displays tremendously.
  681.  
  682.      My thanks to these individuals.
  683.  
  684.  
  685.      Also, thank you to all those of you who made suggestions to help improve
  686.      this product, and contributed sample *.PPP files.  And most of all, thanks
  687.      to those of you who were honorable enough to contribute the $20.00 fee for
  688.      continued development of this product.
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726. (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved               12
  727.  
  728.  
  729.  
  730. Programmable Printer PopUp Users Guide                            Version 1.08
  731.  
  732.  
  733.  6.0  Revision History
  734.  
  735.      6/03/88 Rev 1.08
  736.  
  737.              PPP now remembers the drive as well as the path in which the *.PPP
  738.              files reside.  Previous versions required that you be logged on to
  739.              the correct drive to change printer files.
  740.  
  741.              PPP now recognizes "/" as a valid command line switch, as well as
  742.              "\" and "-".
  743.  
  744.              If no byte value follows the "-R" option, a default value of 111
  745.              will be used (<ALT> F8).
  746.  
  747.              The "Change Hotkey" and "Change Printer File" options can be
  748.              accessed from the main print menu directly by using F9 and F10.
  749.  
  750.              F1, F9, F10 are now reserved for menu control, and cannot be used
  751.              as hotkeys.  F2 is now available as a hotkey.
  752.  
  753.              PPP now supports 50 different printer options (instead of 20), and
  754.              up to 20 printer definition files.
  755.  
  756.              Display of printer definition files is now handled correctly for
  757.              many files.
  758.  
  759.              <Page Up> and <Page Down> are now supported to allow paging through
  760.              complex printer definition files.
  761.  
  762.              The bottom line of the main menu now displays the number of the
  763.              option which is next to the option pointer, and the total number of
  764.              options.
  765.  
  766.              Other various changes, including graphics characters for a classier
  767.              display.
  768.  
  769.      2/05/88 Rev 1.07
  770.  
  771.              Rewrote PPP to take advantage of newer version of STAY-RES routines
  772.              to eliminate "Interrupt xx already in use" error message.
  773.  
  774.              Option pointer ">" was written in wrong place after returning from
  775.              help menu.  After help, default is now option 1.
  776.  
  777.              Only F3 - F10, <ALT> F1 - <ALT> F10, and <CTRL> F1 - <CTRL> F10 are
  778.              now recognized as valid hotkeys.  This was done to prevent common
  779.              keys like "J" to be defined as hotkeys (which is a real pain).  F1
  780.              and F2 are reserved for menu control.
  781.  
  782.      5/06/87 Rev 1.06
  783.  
  784.              Initial product release (internal rev level 1.06).
  785.  
  786.  
  787.  
  788.  
  789. (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved               13
  790.